 |
ALPHA-VISION® AbvEditor: PDM Insert |
PDM Insert
SUMMARY
Via the pull-down menu 'Insert' graphic objects may be inserted.CONTENTS
- Introduction
- Properties of graphic objects
- Rectangle
- Ellipse
- Polygon
- Linie
- Arc
- Pie
- Text
- Figure
- Bitmap
- Text Edit Field
- Numeric Editfield
- Entryfield
- Listbox
- Partial Picture
- Checkbox
- Button
- Slider
- Bargraph
- Graph
- Digital Meter
- Analogue Meter
Introduction
Via that pull-down menu graphic objects may be inserted.
If an object is selected by mouse click, the mouse pointer changes to a hair
cross.
(On selecting a ‘Figure’ or a ‘Bitmap’ a dialog window opens and offers to
select the appropriate object)
The left mouse button is used to select the wanted position and to draw up the
wanted size.
The status line shows the name, the position and the size of the object
dynamically.
Via the pull-down menu
AbvEditor PDM Edit using category
‘General’ the properties of graphic objects can be modified.
Properties of graphic objects
Part of the attributes are line-, foreground- and background color; there are independent adjustable via the color bars or the pull-down menu ‘Edit’ of the Editor item ‘Attributes sequential', category ‘General’. As a color for ‘Line’ and ‘Fill’ of graphic objects also “Transparent” may be selected, thereby the frame, the filling or both of them are invisible, but existent. A text written with transparent background is displayed without frame, but in the selected line color on top of wherever it was placed.
The binding is done via:
- Functions, that do have Data Objects as parameters, which return values or strings during runtime.
- Actions, that do have Data Objects as parameters; the change of value or string of that Data Objects initiates an action in runtime.
Rectangle
A rectangle is always aligned parallel to the screen margin.
Properties:
| Attributes | line color, fill color, line style, fill pattern |
|---|---|
| Individually properties | none |
| Binding | Dynamic |
| native edit mode | no |
Ellipse
Die Achsen einer Ellipse verlaufen immer parallel zu den Bildschirmrändern.
Properties:
| Attributes | line color, fill color, line style, fill pattern |
|---|---|
| Individually properties | none |
| Binding | Dynamic |
| native edit mode | no |
Polygon
A polygon is a sequential list of points joint by straight lines. The
endpoints of a polygon must not be coextensive.
If the polygon is drawn with a fill color not transparent, the start- and
end point will be connected.
Properties:
| Attributes | line color, fill color, line style, fill pattern |
|---|---|
| Individually properties | none |
| Binding | Dynamic |
| native edit mode | yes |
The mode allows moving, deleting or adding points within a polygon.
Any polygon point got its own handle that can be selected by the left mouse button and than moved while holding the mouse button down.
Adding a polygon point is done by holding the ‘Ctrl’ button down while selecting an existing handle with the left mouse button and moving it from its original position.
Deleting a polygon point is done by holding the ‘Ctrl’ + ‘shift’ button down while clicking the handle of the point to be deleted with the left mouse button.
Via the category ‘Dynamic’ in the pull-down menu ‘Edit’, item ‘Attributes sequential’ (global) the polygon might be dynamized.
Linie
A line got two points that are connected linear.
Properties:
| Attributes | line color,line style |
|---|---|
| Individually properties | none |
| Binding | Dynamic |
| native edit mode | no |
Arc
An arc is the cutout of an ellipse. The center point and two control points
define the arc.
Properties:
| Attributes | line color, line style |
|---|---|
| Individually properties | none |
| Binding | Dynamic |
| native edit mode | yes |
The native edit mode may be entered by double click to the arc or – after selecting the arc – via the pull-down menu ‘Edit’, item “Object”.
The mode shows the center point und the control points of the arc. The control points are shown with their handles; via the handles they might be moved.
Via the category ‘Dynamic’ in the pull-down menu ‘Edit’, item ‘Attributes sequential’ (global) the arc might be dynamized.
Pie
An pie is the cutout of an ellipse. The center point and two control points
define the pie. A pie can be filled
Properties:
| Attributes | line color, fill color, line style, fill pattern |
|---|---|
| Individually properties | none |
| Binding | Dynamic |
| native edit mode | yes |
The native edit mode may be entered by double click to the pie or – after selecting the arc – via the pull-down menu ‘Edit’, item “Object”.
The mode shows the center point und the control points of the pie. The control points are shown with their handles; via the handles they might be moved.
Via the category ‘Dynamic’ in the pull-down menu ‘Edit’, item ‘Attributes sequential’ (global) the pie might be dynamized.
Text
A text is inserted as a ‘text field’ first and it is written into that
field afterwards.
The key combination ‘Ctrl’ + ‘Enter’ inserts a line break.
A text field can be aligned in its direction (left, right, up, down).
A text can be aligned within the text field.
Properties:
| Attributes | line color(text color), fill color(text field color |
|---|---|
| Individually properties | font, style, size |
| Binding | Dynamic, Variable, Format |
| native edit mode | yes |
As individually properties the font, style and size of the text is defined.
The native edit mode may be entered by double click to the text or – after selecting the text field – via the pull-down menu ‘Edit’, item “Object”.
Via the categories "Dynamik", "Variablen", "Format" in the pull-down menu ‘Edit’, item ‘Attributes equential’ (global) the text might be modified.
Figure
With the help of figures the different states of the same elements like
switch, valve, etc. are displayed in runtime.Figures are also used to draw
recurring elements only once.
A Figure is created like any picture, it is created in arbitrary size and
saved under its own name that is used to insert it in other pictures,
menus, etc.; it is also possible to insert a figure in a figure.
Properties:
| Attributes | non |
|---|---|
| Individually properties | Mirror, Rotate, Size |
| Binding | Dynamic, Figure parameter |
| native edit mode | yes |
A placed figure can be sized, rotated and mirrored within a picture.
The native edit mode can be entered by double click to the figure or -
after selecting the figure – via the pull-down menu ‘Edit’, item “Object”.
The figure is opened in its own window.
Modifications of a figure become valid, in all the pictures where the
figure is placed, after saving the file.
Via the category ‘Dynamic’ in the pull-down menu ‘Edit’, item ‘Attributes sequential’ (global) figures can be replaced; via the category ‘Figure parameter’ the binding of Data Objects can be modified.
Bitmap
A bitmap is square element that holds a pixel file with the extension
“.bmp”.
In the editor bitmaps can be displayed in its original size only – i.e. if
the pulled up frame is to small the bitmap is shown incomplete, if the
frame is to big the bitmap does not fill it. In runtime a bitmap is scaled
into the given frame.
A bitmap may also be used as a label for buttons.
Properties:
| Attributes | non |
|---|---|
| Individually properties | non |
| Binding | non |
| native edit mode | no |
- The defined bitmap must exist in the runtime area too.
- The filename for the bitmap must have 9 or less character. (Without file extension)
Text Edit Field
A ‘text edit field’ is a square where in runtime a string can be inputted.
Properties:
| Attributes | line color(text color), fill color(background color) |
|---|---|
| Individually properties | font, style, size, apply group |
| Binding | Dynamic, Action, Enable |
| native edit mode | no |
As individually properties the font, style and size of the Text Edit Field is defined.
In the pull-down menu ‘Edit’, item ‘Attributes Sequential’(‘Global’) the categories “Dynamic”, Action”, “Enable” allow modifying the text entry field.
As example, the action " Obj_SetAttr" might be bound to the field, it can
set the text of a Data Object.
That action expects as parameter1 the PointID, as parameter2 the attribute
‘txt’ and as last parameter the text to be set. That parameter is not set
when binding the action to the text edit field, but it is supplied in
runtime by the user.
If more than one text and/or value entries has to be made it might be
useful to finish all modifications before handing them over to the system.
If, beside the action for the text edit field, an ‘apply group’ is defined,
the handover of data is done by the action
"Apply_Ctrl<Apply group>" bound to a button.
Numeric Editfield
A ‘numeric edit field’ is a square where in runtime a value can be inputted.
Properties:
| Attributes | line color(text color), fill color(background color) |
|---|---|
| Individually properties | font, style, size, apply group |
| Binding | Dynamic, Action, Format, Enable |
| native edit mode | no |
As individually properties the font, style and size of the Numeric Edit Field is defined.
In the pull-down menu ‘Edit’, item ‘Attributes Sequential’(‘Global’) the categories “Dynamic”, Action”, “Enable” allow modifying the Numeric Entry Field.
As example, the action " Obj_SetAttr" might be bound to the field, it can
set the value of a Data Object.
That action expects as parameter1 the PointID, as parameter2 the attribute
‘value’ and as last parameter the value to be set. That parameter is not
provided when binding the action to the value edit field, but it is
supplied in runtime by the user.
Via the category ‘Format’ the indication of the Numeric Edit Field is
formatted. The definition is done in the “Picture” field of the ‘Text
format’ using placeholder. Placeholder are strings consisting of the
characters "+", "-", ".", "0" und "9". For inputting date/time "CE", "YE",
"MO", "DA", (date) and "HO", "MI", "SE" (time) are valid.
Meaning of the placeholder:
| + | Forces that the value is signed, even for positive values. |
|---|---|
| - | Is used as placeholder for negative values; if "-" is not set negative values may be inputted, but not displayed; only "*" are shown. |
| . | Decimal point |
| 9 | Single digit (leading zeros, resp. ending zeros after the decimal point are NOT displayed) |
| 0 | Single digit (leading zeros, resp. ending zeros after the decimal point are displayed) |
| CE | Century (two-digit) |
| YE | Year ((two-digit)) |
| MO | Month (two-digit) |
| DA | Day (two-digit) |
| HO | Hour (two-digit) |
| MI | Minute (two-digit) |
| SE | Second (two-digit) |
Entryfield
Entry Fields are elements of a List Box, used to display a set of
information.
Properties:
| Attributes | line color, fill color, fill pattern |
|---|---|
| Individually properties | none |
| Binding | non |
| native edit mode | no |
The entries are taken from one of four servers:
| Data Object Server: | "$ACT" represents a Data Object |
|---|---|
| Event Server: | "$ACT" represents a Data Object referring to an event of the archive. |
| Alarm Server: | "$ACT" represents a Data Object referring to an alarm of the archive. |
| Section Server: | "$ACT" represents a Data Object of a section |
Via "Label Entryfield" in the pull-down menu ‘Arrange’ the graphic objects querying properties of server entries are bound to the Entry Field. Thereby the size of the Entry Field is adjusted to the size of all graphic objects in question. To access again a single graphic object the Entry Field and the graphic objects must be ‘ungrouped’.
Listbox
A ListBox is a gathering of EntryFields.
EntryFields might be arranged in lines or columns.
Properties:
| Attributes | line color, fill color, fill pattern |
|---|---|
| Individually properties | none |
| Binding | non |
| native edit mode | no |
Possible Servers and Cursors:
| Data Object Server: | The cursor connects by "Crsr_OpenObj(<CursorName>)" |
|---|---|
| Event Server: | The cursor connects by "Crsr_OpenEvnt(<CursorName>)" |
| Alarm Server: | The cursor connects by "Crsr_OpenAlarm(<CursorName>)" |
| Section Server: | The cursor connects by "Crsr_OpenSd(<CursorName>)" |
Via "Label Listbox" in the pull-down menu ‘Arrange’ all EntryFields
are bound to the List Box. Thereby the size of the List Box is adjusted to
the size of all EntryFieldsin question.
The sequence the EntryFields in runtime are supplied with information is
equal to the sequence the EntryFields were created.
To again access a single EntryField the ListBox and the EntryFields must be
‘ungrouped’.
Partial Picture
- not used -
Checkbox
The Checkbox is a control element with predefined image; on inserting it is
defined by its position and size. The element is used to prepare actions that
then are triggered by a button.
Properties:
| Attributes | line color |
|---|---|
| Individually properties | Apply Group |
| Binding | Dynamic, Action, Enable |
| native edit mode | no |
The "Checkbox" is treated like a button, but cannot be labeled. In
addition an "Apply group" is bound to it.
To a button the action "Apply_Ctrl(<Apply group>) is bound.
By clicking the "Checkbox" in runtime the action bound to it gets
prepared (marked).
(On any click to the Check Box it is toggled between marked/unmarked;
a marked Check Box is displayed in the defined Line Color, an unmarked one
is gray.)
If "Apply_Ctrl<(Apply group)>)" is executed, all actions bound
to a marked Check Box with identical Apply group are forwarded to the
system.
Button
The Button is a control element with predefined image; on inserting it is
defined by its position and size.
Properties:
| Attributes | non |
|---|---|
| Individually properties | labeling element |
| Binding | Action, Enable |
| native edit mode | no |
A button can be labeled by other elements (text, figure, etc.). To label a button both elements must be selected and then grouped by the action “Label button“ in the pull-down menu ‘Arrange’. The element used to label the button is thereby aligned to the size of the button.
Slider
The slider is a control element with predefined image; on inserting it is
defined by its position and size. The element is used for stepless control
of values in a given range.
Properties:
| Attributes | fill color |
|---|---|
| Individually properties | Direction, Arrow-Direction |
| Binding | Action, format, enable, scaling |
| native edit mode | no |
Bargraph
The bar graph is used to display the value of a Data Object in a graphic
way; in the editor initially it is defined in its position and size.
Properties:
| Attributes | line color, fill color |
|---|---|
| Individually properties | direction, bargraph style |
| Binding | Dynanic, variable, scaling |
| native edit mode | no |
Via the categories "Dynamic" - "Variables" - "Format" - "scaling" of the pull-down menu ‘edit’, item Attribute Sequential" ("Global") in the AbvEditor, PDM Edit the functionality of a bargraph can be defined.
Graph
The graph is used to display the value of a Data Object as a curve in
dependency of the time; in the editor initially it is defined in its
position and size.
Properties:
| Attributes | line color |
|---|---|
| Individually properties | direction, graph style |
| Binding | Dynanic, variable, scaling |
| native edit mode | no |
Via the categories "Dynamic" - "Variables" - "Format" - "scaling" of the pull-down menu ‘edit’, item Attribute Sequential" ("Global") in the AbvEditor, PDM Edit the functionality of a graph can be defined.
Digital Meter
The digital meter is used to display the value of a Data Object as a numeric
value; in the editor initially it is defined in its position and size.
Properties:
| Attributes | line color, fill color |
|---|---|
| Individually properties | direction, Text format |
| Binding | Dynanic, variable, scaling |
| native edit mode | no |
Via the categories "Dynamic" - "Variables" - "Format" - "scaling" of the pull-down menu ‘edit’, item Attribute Sequential" ("Global") in the AbvEditor, PDM Edit the functionality of a difital meter can be defined.
Analogue Meter
The analogue meter is used to display the value of a Data Object as an analogue
value; in the editor initially it is defined in its position and size.
Properties:
| Attributes | line color, fill color, line style, fill pattern |
|---|---|
| Individually properties | Style (line, bar) |
| Binding | Dynanic, variable, scaling |
| native edit mode | no |
Via the categories "Dynamic" - "Variables" - "Format" - "scaling" of the pull-down menu ‘edit’, item Attribute Sequential" ("Global") in the AbvEditor, PDM Edit the functionality of an analogue meter can be defined.